package org.ehe.business.bom.service;

import com.baomidou.mybatisplus.extension.service.IService;
import org.ehe.business.bom.domain.BomStructure;

import java.math.BigDecimal;
import java.util.List;

/**
 * @author :zhangnn
 * @className :BomStructureService
 * @description: TODO
 * @date 2025-07-30 13:54:09
 */
public interface BomStructureService extends IService<BomStructure> {
    /**
     * 复制目标版本的BOM结构
     * @param targetVersionId
     * @param id
     */
    void copyBomStructure(Long targetVersionId, Long id);

    /**
     * 添加BOM结构项
     * @param structure
     */
    void addBomStructureItem(BomStructure structure);

    /**
     * 计算初步成本
     * @param id
     * @return
     */
    BigDecimal calculateBomTotalCost(Long id);

    /**
     * 检查BOM结构完整性
     * @param id
     * @return
     */
    List<String> validateBomStructureIntegrity(Long id);

    /**
     * 获取BOM版本的完整结构树
     * @param id
     * @return
     */
    List<BomStructure> getBomStructureTree(Long id);

    /**
     * 查找关键物料
     * @param id
     * @return
     */
    List<BomStructure> getKeyItems(Long id);

    /**
     * 批量更新供应商信息
     * @param bomVersionId
     * @param itemId
     * @param supplierId
     * @param supplierName
     */
    void updateSupplierInfo(Long bomVersionId, Long itemId, Long supplierId, String supplierName);

    /**
     * 展开BOM结构
     * @param id
     * @return
     */
    List<BomStructure> getBomMaterialList(Long id);

    /**
     * 删除BOM结构项（包括子项）
     * @param id
     */
    void deleteBomStructureItem(Long id);

    /**
     * 更新物料单价并重新计算总价
     * @param bomVersionId
     * @param itemId
     * @param newUnitPrice
     */
    void updateItemPrice(Long bomVersionId, Long itemId, BigDecimal newUnitPrice);

    /**
     * 更新BOM结构项
     * @param structure
     */
    void updateBomStructureItem(BomStructure structure);

    void clearVersionStructures(Long id);
}
